home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u286.dms / u286.adf / ARP / ARPManual / Ask < prev    next >
Text File  |  1991-07-28  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4.      Ask(REL2)             ARP User's    Manual             Ask(REL2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Ask -    Query user interactively.
  10.  
  11.      SYNOPSIS
  12.       Ask Prompt WARN OK TIMEOUT
  13.  
  14.      DESCRIPTION
  15.       Ask is a program that    allows you to get a simple form    of
  16.       input    from a user.  It is most useful    in Execute scripts.
  17.  
  18.       You may specify a Prompt string, which will be displayed to
  19.       the user, and    you may    also specify a string to match on for
  20.       both YES and NO responses, as    well as    specifying a time
  21.       limit    on the users response in seconds.  All of these
  22.       strings are have default values, the default for the WARN
  23.       string is 'Y', the default for the OK    string is 'N', and the
  24.       default for the Prompt is a single question mark.
  25.  
  26.       If the user enters a string which matches the    WARN string,
  27.       ask will exit    with a return code that    will cause a IF    WARN
  28.       statement to succeed.     If the    user enters a string which
  29.       matches the OK string, exceeds the value given in TIMEOUT,
  30.       or simply hits RETURN    then Ask will exit with    a ZERO return,
  31.       suitable for the ELSE    portion    of such    an IF statement.
  32.  
  33.       If the user enters a string other than those specified in
  34.       WARN and OK, then ASK    will redisplay the prompt, urging the
  35.       user to give a better    answer.
  36.  
  37.      EXAMPLE
  38.       Here is an example of    a Ask command which will return    a
  39.       WARNING if the User types "Amiga", and an OK if the user
  40.       types    BigBlue, or waits longer than 10 seconds to respond:
  41.  
  42.       Ask "Amiga or    BigBlue?" "Amiga" "BigBlue" Timeout 10
  43.       IF WARN  ; typed amiga!
  44.       Echo "Obviously a person of quality"
  45.       ELSE ; typed big blue? or couldn't decide
  46.       Echo "You are    obviously misguided"
  47.       ENDIF
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.